home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_perl.idb / usr / freeware / catman / u_man / cat1 / h2ph.Z / h2ph
Encoding:
Text File  |  1998-10-28  |  4.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      HHHH2222PPPPHHHH((((1111))))         22223333////OOOOcccctttt////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222))))           HHHH2222PPPPHHHH((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       h2ph - convert .h C header files to .ph Perl header files
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       hhhh2222pppphhhh [[[[----dddd ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn ddddiiiirrrreeeeccccttttoooorrrryyyy]]]] [[[[----rrrr ||||    ----aaaa]]]] [[[[----llll]]]] [[[[hhhheeeeaaaaddddeeeerrrrffffiiiilllleeeessss]]]]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       _h_2_p_h converts    any C header files specified to    the
  16.       corresponding    Perl header file format.  It is    most easily
  17.       run while in /usr/include:
  18.  
  19.           cd /usr/include; h2ph    * sys/*
  20.  
  21.       or
  22.  
  23.           cd /usr/include; h2ph    -r -l .
  24.  
  25.       The output files are placed in the hierarchy rooted at
  26.       Perl's architecture dependent    library    directory.  You    can
  27.       specify a different hierarchy    with a ----dddd switch.
  28.  
  29.       If run with no arguments, filters standard input to standard
  30.       output.
  31.  
  32.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  33.       -d destination_dir
  34.           Put the resulting    ....pppphhhh files beneath ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn____ddddiiiirrrr,
  35.           instead of beneath the default Perl library location
  36.           ($Config{'installsitsearch'}).
  37.  
  38.       -r  Run recursively; if any of hhhheeeeaaaaddddeeeerrrrffffiiiilllleeeessss are directories,
  39.           then run _h_2_p_h on all files in those directories (and
  40.           their subdirectories, etc.).  ----rrrr and ----aaaa are mutually
  41.           exclusive.
  42.  
  43.       -a  Run automagically; convert hhhheeeeaaaaddddeeeerrrrffffiiiilllleeeessss, as well as any
  44.           ....hhhh files which they include.  This option    will search
  45.           for ....hhhh files in all directories which your C compiler
  46.           ordinarily uses.    ----aaaa and ----rrrr are mutually exclusive.
  47.  
  48.       -l  Symbolic links will be replicated    in the destination
  49.           directory.  If ----llll    is not specified, then links are
  50.           skipped over.
  51.  
  52.       -h  Put ``hints'' in the .ph files which will    help in
  53.           locating problems    with _h_2_p_h.  In those cases when    you
  54.           rrrreeeeqqqquuuuiiiirrrreeee a    ....pppphhhh file containing syntax errors, instead of
  55.           the cryptic
  56.  
  57.               [    some error condition ] at (eval    mmm) line nnn
  58.  
  59.           you will see the slightly    more helpful
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 10/23/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      HHHH2222PPPPHHHH((((1111))))         22223333////OOOOcccctttt////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222))))           HHHH2222PPPPHHHH((((1111))))
  71.  
  72.  
  73.  
  74.               [    some error condition ] at filename.ph line nnn
  75.  
  76.           However, the ....pppphhhh files almost double in size when    built
  77.           using ----hhhh.
  78.  
  79.       -D  Include the code from the    ....hhhh file    as a comment in    the
  80.           ....pppphhhh file.     This is primarily used    for debugging _h_2_p_h.
  81.  
  82.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  83.       No environment variables are used.
  84.  
  85.      FFFFIIIILLLLEEEESSSS
  86.        /usr/include/*.h
  87.        /usr/include/sys/*.h
  88.  
  89.       etc.
  90.  
  91.      AAAAUUUUTTTTHHHHOOOORRRR
  92.       Larry    Wall
  93.  
  94.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  95.       _p_e_r_l(1)
  96.  
  97.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  98.       The usual warnings if    it can't read or write the files
  99.       involved.
  100.  
  101.      BBBBUUUUGGGGSSSS
  102.       Doesn't construct the    %sizeof    array for you.
  103.  
  104.       It doesn't handle all    C constructs, but it does attempt to
  105.       isolate definitions inside evals so that you can get at the
  106.       definitions that it can translate.
  107.  
  108.       It's only intended as    a rough    tool.  You may need to dicker
  109.       with the files produced.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 10/23/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      HHHH2222PPPPHHHH((((1111))))         22223333////OOOOcccctttt////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222))))           HHHH2222PPPPHHHH((((1111))))
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.      Page 3                        (printed 10/23/98)
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.